org.globalplatform
Interface SecureChannelx

All Superinterfaces:

SecureChannel, javacard.framework.Shareable

public interface SecureChannelx
extends SecureChannel

This defines an interface which extends SecureChannel Interface and includes a supplementary method. See SecureChannel interface for a description of the underlying interface. Prior to using this interface, an Application is required to obtain a handle to its associated Security Domain's SecureChannelx interface object by invoking the GPSystem.getSecureChannel() method and casting the returned object to type SecureChannelx. The SecureChannelx Interface shall be implemented by a Security Domain compliant to this version of the specification and the corresponding object reference shall be exposed through the GPSystem.getSecureChannel() method.

Since:

export file version 1.1

See Also:

SecureChannel

Field Summary

Fields inherited from interface org.globalplatform.SecureChannel

ANY_AUTHENTICATED, AUTHENTICATED, C_DECRYPTION, C_MAC, NO_SECURITY_LEVEL, R_ENCRYPTION, R_MAC

Method Summary

void	setSecurityLevel(byte bSecurityLevel) This method updates the Current Security Level for all subsequent invocations of wrap() and unwrap() methods, except when Secure Channel is not active or was aborted during the same Application session.

Methods inherited from interface org.globalplatform.SecureChannel

decryptData, encryptData, getSecurityLevel, processSecurity, resetSecurity, unwrap, wrap

Method Detail

setSecurityLevel

void setSecurityLevel(byte bSecurityLevel)

This method updates the Current Security Level for all subsequent invocations of wrap() and unwrap() methods, except when Secure Channel is not active or was aborted during the same Application session. Current Security Level is coded as a bit-map according to table 10-1. The current Security Level cannot be set below the compulsory Session Security Level, buty only equal or above. The Current Security Level may be increased or decreased during a Secure Channel Session as long as it is at least equal to the compulsory Session Security Level.

Notes:

• This method fails if a Secure Channel Session is not open, if the corresponding session keys are not available or if the Current Security Level is equal to NO_SECURITY_LEVEL.

Parameters:

bSecurityLevel -

the Current Security Level to be set.

Throws:

ISOException - with the following reason codes (other security mechanism related status words may be returned):

• ISO7816.SW_CONDITION_NOT_SATISFIED